home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / wb / czesc_2 / makeicons / makeicons.doc < prev    next >
Text File  |  1992-03-22  |  14KB  |  277 lines
  1. MakeIcons Version 1.0
  2.  
  3.  
  4. INTRODUCTION
  5.  
  6.      MakeIcons creates new icons and revises existing ones.  You control the
  7. operations MakeIcons will perform and the files on which it will perform
  8. them.  With existing icons you can have it replace icon images, replace
  9. tooltypes, or make their positions automatic.  You choose the types of files
  10. it will operate on: drawers, projects, or tools.  You control whether
  11. MakeIcons will look inside drawers within the drawers you selected.  You can
  12. change the icons that MakeIcons will use as patterns.
  13.  
  14.  
  15. SHAREWARE
  16.  
  17.      MakeIcons is shareware.  It's just $10.  If you wouldn't buy it in a
  18. store for that price send me what you would pay for it.  If you wouldn't pay
  19. anything for it I'd like to know why.  Comments, criticisms, or suggestions
  20. for improvements are welcome too.
  21.  
  22.    Fabbian G. Dufoe, III
  23.    350 Ling-A-Mor Terrace South
  24.    St. Petersburg, Florida  33705
  25.  
  26.    GEnie: F.DUFOE3
  27.  
  28.  
  29. INSTRUCTIONS
  30.  
  31.      You start MakeIcons from the Workbench.  Select MakeIcons and the
  32. drawers containing the items you want to process using extended selection. 
  33. Click once on MakeIcons.  Hold down the shift key and click on the other
  34. icons.  Double click on the last one.  Release the shift key.
  35.  
  36.      MakeIcons behaves differently depending on whether you select an icon
  37. that can contain files (a disk or drawer icon) or an icon for a single file
  38. (a project or tool icon).  If you select a single file MakeIcons will work
  39. on that file and no others.  If you select a disk or drawer MakeIcons will
  40. work on the files within that disk or drawer, but not on the disk or drawer
  41. icon itself.
  42.  
  43.      MakeIcons will open a small window that displays the name of the first
  44. icon you selected and lets you select the options you want.  The window
  45. looks something like this.
  46.  
  47.       **************************************************
  48.       *MakeIcons ©1991 by F. G. Dufoe, III             *
  49.       *                                                *
  50.       *File:                                           *
  51.       *            Create   -------Replace Icon--------*
  52.       *             Icons   Images  Tooltypes  Position*
  53.       *Drawers:       o       o        o          o    *
  54.       *Projects:      o       o        o          o    *
  55.       *Tools:         o       o        o          o    *
  56.       * o  Include subdirectories                      *
  57.       *Files checked:                                  *
  58.       *Icons created:                                  *
  59.       *  OK                                    Cancel  *
  60.       **************************************************
  61.  
  62.      Options that are selected are identified by a check mark.  You can
  63. switch options on or off by checking their box.  Move the mouse pointer to
  64. the box and click the left button.  Check boxes will toggle between selected
  65. (a check mark appears) and unselected (the check mark disappears) states. 
  66. If you like you can pre-select which boxes will be checked when the window
  67. opens by supplying "TOOL TYPES".  The section below headed "Customizing"
  68. tells you how to do it.
  69.  
  70.      The vertical columns identify the four operations you can select. 
  71. Operations affect only those types of files which correspond to the row in
  72. which the check box is selected.  If a box in a column is checked here is
  73. what the program does.
  74.  
  75.  
  76.           Create Icons   Create icons for any files that don't already have
  77.                          them.  The icons will be arranged so they don't
  78.                          overlap.
  79.  
  80.  
  81.                                 Replace Icon
  82.  
  83.           Images         Replace the image for any existing icons with a new
  84.                          image.
  85.  
  86.           Tooltypes      For any existing icons, replace the stack size and
  87.                          tooltypes information.  (For project icons, replace
  88.                          the default tool as well.)
  89.  
  90.           Position       Frees the icon from a fixed position so that it
  91.                          will be arranged automatically.
  92.  
  93.      You control the types of files you want MakeIcons to act on by checking
  94. the boxes in the corresponding rows.  For example, if you want to create
  95. icons for directories but not for projects or tools and you don't want to
  96. alter any existing icons you would select the check box in the "Create
  97. Icons" column on the "Directories" row.  You can select any combination of
  98. rows and columns.
  99.  
  100.      The option labelled "Include subdirectories" controls whether
  101. MakeIcons will look inside drawers (also called directories) within the
  102. drawers you selected.  If you checked "Include subdirectories" MakeIcons
  103. will open subdirectories and process the files inside them according to the
  104. options you selected.  If not MakeIcons will do what you asked to any
  105. drawers it finds but it won't do anything to the files inside them.
  106.  
  107.      Select the "OK" gadget to start processing or select the "Cancel"
  108. gadget to end the program without doing anything.
  109.  
  110.  
  111. CHANGING ICON PATTERNS
  112.  
  113.      You may change the icons that MakeIcons uses as patterns.  MakeIcons
  114. uses the icons in the "Icons" drawer as patterns for new icons.  By changing
  115. or replacing those icons you can change the icons that MakeIcons will
  116. create.  You can use the Workbench "Info" menu item to change the stack
  117. size, tool types, and default tool for any icons.  You can use the icon
  118. editor (IconEd) on your Extras disk to change the icon images.  Or you can
  119. simply replace the icons with others you like better.
  120.  
  121.      If you want to use lots of different patterns MakeIcons has an easy way
  122. to do it.  Add "DEFAULT=SELECT" to the MakeIcons tooltypes (see the
  123. CUSTOMIZING section below for more information about changing tooltypes). 
  124. Now MakeIcons will use the first icon you select (after the MakeIcons
  125. program icon) as the pattern.  It will apply that pattern to any additional
  126. icons you select.  The "DEFAULT=SELECT" tooltype will pre-select all the
  127. check boxes (except "Position") on the row corresponding to the icon type
  128. you selected.  You can, of course, change any of the check box selections if
  129. you want.
  130.  
  131.      For example, if you select MakeIcons, a tool called "Grep", another
  132. tool called "Ls", and a drawer called "Junk" MakeIcons will pre-select the
  133. check boxes on the "Tool" line.  When you click the "OK" box MakeIcons will
  134. replace the imagery and tooltypes for Ls and all the tool icons in Junk
  135. with Grep's tooltypes and imagery.  And it will create new tool icons for
  136. any tools it finds in Junk which don't already have them.
  137.  
  138.  
  139. TROUBLE-SHOOTING
  140.  
  141.      If you started MakeIcons without selecting any icons there won't be an
  142. "OK" or "Cancel" gadget.  Instead, you'll see a message saying "No
  143. directories were selected.  Select close gadget to exit."  Move the mouse
  144. pointer to the close gadget in the upper left corner of the window and click
  145. the left mouse button once.
  146.  
  147.      If MakeIcons cannot find the drawer which holds the default icons it
  148. will stop with an error message.  MakeIcons looks in three drawers for the
  149. default icons it uses.  First it looks in the "Icons" drawer in the same
  150. drawer with MakeIcons.  Next it looks in "ENV:sys".  Finally, it looks in
  151. "SYS:Prefs/Env-Archive/sys".
  152.  
  153.      MakeIcons copies everything from the default icon except its name and
  154. position when it creates a new icon.  When MakeIcons modifies existing icons
  155. it copies the information you selected from the default icons except for the
  156. position.  MakeIcons creates all its icons without a fixed position. 
  157. Workbench will arrange them so they don't overlap.
  158.  
  159.      There must be three default icons in the default icons drawer: a drawer
  160. icon named "def_drawer", a tool icon named "def_tool", and a project icon
  161. named "def_project".  To save disk space, the files these icons represent
  162. may be deleted.  Otherwise, there's nothing special about these icons.  If
  163. you don't like the ones in the icons drawer you can replace them with some
  164. you like better.  If the icons drawer is missing or if any of the icons are
  165. missing MakeIcons will display a message to indicate what is missing.  Here
  166. are the messages you might see along with the corrective action you should
  167. take.
  168.  
  169.      Couldn't find default icons drawer.
  170.           Create an "Icons" drawer in the same drawer as "MakeIcons".  One
  171.           way to do that is to copy the "Empty" drawer from your Workbench
  172.           disk, then rename it to "Icons".  Use the "Info" item from the
  173.           Workbench menu to determine the icon type if you have any doubt. 
  174.           If you are using Workbench 2.0 you can use "IconEdit" from the
  175.           "Tools" drawer on your "Extras2.0" disk to copy (or draw) an icon,
  176.           then save it as a default icon.  Workbench will create "ENV:sys"
  177.           to save it.
  178.  
  179.      Couldn't find "def_tool" icon.
  180.           Create a tool icon named "def_tool" in the "Icons" drawer.  If you
  181.           don't have an "Icons" drawer create the tool icon in "ENV:sys" or
  182.           "SYS:Prefs/Env-Archive/sys".  You can find some tool icons in the
  183.           Utilities drawer of your Workbench disk.  Copy one of those to the
  184.           default icons drawer, then rename it "def_tool".  If you are using
  185.           Workbench 2.0 you can use "IconEdit" to copy (or draw) a tool
  186.           icon, then save it as a default icon.  Workbench will create
  187.           "ENV:sys" to save it.
  188.  
  189.      Couldn't find "def_project" icon.
  190.           Create a project icon named "def_project" in the "Icons" drawer. 
  191.           If you don't have an "Icons" drawer create the tool icon in
  192.           "ENV:sys" or "SYS:Prefs/Env-Archive/sys".  You can find project
  193.           icons on your application disks or you can create on by running
  194.           Notepad and saving a file.  Copy the project icon and rename it
  195.           "def_project".  If you are using Workbench 2.0 you can use
  196.           "IconEdit" to copy (or draw) a project icon, then save it as a
  197.           default icon.  Workbench will create "ENV:sys" to save it.
  198.  
  199.      Couldn't find "def_drawer" icon.
  200.           Create a drawer icon named "def_drawer" in the "Icons" drawer. 
  201.           you can copy the "Empty" drawer from your Workbench disk, then
  202.           rename it to "def_drawer".  If you are using Workbench 2.0 you can
  203.           use "IconEdit" to copy (or draw) a drawer icon, then save it as a
  204.           default icon.  Workbench will create "ENV:sys" to save it.
  205.  
  206.      "def_drawer" is not a drawer icon.
  207.      "def_project" is not a project icon.
  208.      "def_tool" is not a tool icon.
  209.           Replace the icon with one of the proper type.  Use the "Info" item
  210.           from the Workbench menu to see an icon's type.  MakeIcons will not
  211.           work unless it can find a drawer icon named "def_drawer", a
  212.           project icon named "def_project", and a tool icon named
  213.           "def_tool".
  214.  
  215.  
  216. CUSTOMIZING
  217.  
  218.      You can change the icon generation options that will be selected by
  219. default.  Select MakeIcons, then choose "Info" from the Workbench menu.  Set
  220. the options by adding or deleting "TOOL TYPES".  These are the entries and
  221. the options they affect:
  222.  
  223.      CREATE=DIRS|PROJECTS|TOOLS
  224.           Selects boxes in the "Create Icons" column.  If "DIRS" is present
  225.           the "Drawers" box will be checked.  If "PROJECTS" is present the
  226.           "Projects" box will be selected.  If "TOOLS" is present the
  227.           "Tools" box will selected.
  228.  
  229.      IMAGES=DIRS|PROJECTS|TOOLS
  230.           Selects boxes in the "Replace Images" column.  If "DIRS" is
  231.           present the "Drawers" box will be checked.  If "PROJECTS" is
  232.           present the "Projects" box will be selected.  If "TOOLS" is
  233.           present the "Tools" box will selected.
  234.  
  235.      TTYPES=DIRS|PROJECTS|TOOLS
  236.           Selects boxes in the "Replace Tooltypes" column.  If "DIRS" is
  237.           present the "Drawers" box will be checked.  If "PROJECTS" is
  238.           present the "Projects" box will be selected.  If "TOOLS" is
  239.           present the "Tools" box will selected.
  240.  
  241.      POSITION=DIRS|PROJECTS|TOOLS
  242.           Selects boxes in the "Replace Position" column.  If "DIRS" is
  243.           present the "Drawers" box will be checked.  If "PROJECTS" is
  244.           present the "Projects" box will be selected.  If "TOOLS" is
  245.           present the "Tools" box will selected.
  246.  
  247.      RECURSIVE=YES
  248.           Selects "Include subdirectories".
  249.  
  250.      DEFAULT=SELECT
  251.           MakeIcons will use the first icon (excluding the icon for the
  252.           MakeIcons program) as the template for that type of icon and all
  253.           operations for that type of icon will be selected (overriding the
  254.           other Tooltypes settings).  All the operations for other types of
  255.           icons will be cleared.
  256.  
  257.  
  258. TRASHCANS
  259.  
  260.      In closing, a brief word about trashcans.  AmigaDOS normally creates a
  261. directory (drawer) called "Trashcan" when it formats a disk.  At the same
  262. time it creates a "Garbage" icon for it.  A "Garbage" icon has some special
  263. properties.  It can't be discarded and it can't be moved out of its window. 
  264. When it is selected its contents can be deleted by choosing the "Empty
  265. Trash" item from the Workbench "Disk" menu.
  266.  
  267.      You can rename "Trashcan".  There is nothing about the "Garbage" icon
  268. type that prevents renaming.  And you can use the command line interface
  269. (CLI) or shell to delete the directory, the icon, or both.
  270.  
  271.      What's tricky about "Garbage" icons is that all the special qualities
  272. are in the icon, not the directory the icon represents.  MakeIcons leaves
  273. "Garbage" icons alone.  As long as a directory has a "Garbage" icon
  274. associated with it MakeIcons will recognize it as a trashcan and ignore it. 
  275. But without an icon MakeIcons can't distinguish it from any other directory
  276. and will create a drawer icon for it.
  277.